'\" t
.TH "TIMEDATECTL" "1" "" "systemd 231" "timedatectl"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
timedatectl \- 控制系统的时间与日期
.SH "SYNOPSIS"
.HP \w'\fBtimedatectl\ \fR\fB[OPTIONS...]\fR\fB\ \fR\fB{COMMAND}\fR\ 'u
\fBtimedatectl \fR\fB[OPTIONS...]\fR\fB \fR\fB{COMMAND}\fR
.SH "描述"
.PP
\fBtimedatectl\fR
可用于查询与修改 系统时钟的各项设置。
.PP
可以使用
\fBsystemd-firstboot\fR(1)
初始化已挂载(但未启动)的系统镜像的时区设置。
.SH "选项"
.PP
能够识别的命令行选项如下：
.PP
\fB\-\-no\-ask\-password\fR
.RS 4
在执行特权操作时不向用户索要密码。
.RE
.PP
\fB\-\-adjust\-system\-clock\fR
.RS 4
当使用
\fBset\-local\-rtc\fR
命令时， 若使用了此选项， 则表示根据RTC时间来更新系统时钟。 若未使用此选项，则表示根据系统时钟来更新RTC时间。
.RE
.PP
\fB\-H\fR, \fB\-\-host=\fR
.RS 4
操作指定的远程主机。可以仅指定一个主机名(hostname)， 也可以使用
"username@hostname"
格式。 hostname 后面还可以加上容器名(以冒号分隔)， 也就是形如
"hostname:container"
的格式， 以表示直接连接到指定主机的指定容器内。 操作将通过SSH协议进行，以确保安全。 可以通过
\fBmachinectl \-H \fR\fB\fIHOST\fR\fR
命令列出远程主机上的所有容器名称。
.RE
.PP
\fB\-M\fR, \fB\-\-machine=\fR
.RS 4
在本地容器内执行操作。 必须明确指定容器的名称。
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
显示简短的帮助信息并退出。
.RE
.PP
\fB\-\-version\fR
.RS 4
显示简短的版本信息并退出。
.RE
.PP
\fB\-\-no\-pager\fR
.RS 4
不将程序的输出内容管道(pipe)给分页程序。
.RE
.PP
能够识别的命令如下：
.PP
\fBstatus\fR
.RS 4
显示系统时钟与RTC的当前状态， 包括时区设置与网络时间同步服务的状态。 注意，所谓"网络时间同步服务的状态"实际上只是
systemd\-timesyncd\&.service
服务的状态， 并不检查是否存在其他时间同步服务。 这是默认命令。
.RE
.PP
\fBset\-time [TIME]\fR
.RS 4
将系统时钟设为指定的时间， 并同时更新RTC时间。 [TIME] 是一个形如 "2012\-10\-30 18:17:16"的时间字符串。
.RE
.PP
\fBset\-timezone [TIMEZONE]\fR
.RS 4
设置系统时区，也就是更新
/etc/localtime
软连接的指向。 可以用下面的
\fBlist\-timezones\fR
命令列出所有可用时区。 如果RTC被设为本地时间， 此命令还会同时更新RTC时间。 详见
\fBlocaltime\fR(5)
手册。
.RE
.PP
\fBlist\-timezones\fR
.RS 4
列出所有可用时区，每行一个。 列出的值可以用作前述
\fBset\-timezone\fR
命令的参数。
.RE
.PP
\fBset\-local\-rtc [BOOL]\fR
.RS 4
设为
"no"
表示在RTC中存储UTC时间； 设为
"yes"
表示在RTC中存储本地时间。 应该尽一切可能在RTC中存储UTC时间。 尽量不要在RTC中存储本地时间， 因为这会造成一系列麻烦， 尤其是在切换时区以及调整夏令时或冬令时的时候。 注意，除非明确使用了
\fB\-\-adjust\-system\-clock\fR
选项， 否则此命令还会同时用系统时钟更新RTC时间。 此命令还会改变
/etc/adjtime
文件第三行的内容，详见
\fBhwclock\fR(8)
手册。
.RE
.PP
\fBset\-ntp [BOOL]\fR
.RS 4
是否开启网络时间同步。 设为
"yes"
则启用并启动
systemd\-timesyncd\&.service
服务， 设为
"no"
则停止并停用它。 该命令除了控制
systemd\-timesyncd\&.service
服务的状态，不做任何其他操作。 也就是说，设为
"yes"
相当于执行
\fBsystemctl enable \-\-now systemd\-timesyncd\&.service\fR
命令； 而设为
"no"
则相当于执行
\fBsystemctl disable \-\-now systemd\-timesyncd\&.service\fR
命令；
.sp
注意，即使使用此命令关闭了
systemd\-timesyncd\&.service
服务， 仍然有可能存在其他时间同步服务。 另外，严格来说，
systemd\-timesyncd\&.service
除了同步时间之外，还同时兼有其他功能， 例如在无网络且无RTC的系统上维持系统的"单调时钟"。 详见
\fBsystemd-timesyncd.service\fR(8)
手册。
.RE
.SH "退出状态"
.PP
返回值为 0 表示成功， 非零返回值表示失败代码。
.SH "环境变量"
.PP
\fI$SYSTEMD_PAGER\fR
.RS 4
指定分页程序。仅在未指定
\fB\-\-no\-pager\fR
选项时有意义。 此变量会覆盖
\fI$PAGER\fR
的值。 将此变量设为空字符串或
"cat"
等价于使用
\fB\-\-no\-pager\fR
选项。
.RE
.PP
\fI$SYSTEMD_LESS\fR
.RS 4
用于覆盖 默认传递给
\fBless\fR
程序的命令行选项 ("FRSXMK")。
.RE
.SH "例子"
.PP
显示当前的时间设置
.sp
.if n \{\
.RS 4
.\}
.nf
$ timedatectl
      Local time: Di 2015\-04\-07 16:26:56 CEST
  Universal time: Di 2015\-04\-07 14:26:56 UTC
        RTC time: Di 2015\-04\-07 14:26:56
       Time zone: Europe/Berlin (CEST, +0200)
 Network time on: yes
NTP synchronized: yes
 RTC in local TZ: no
.fi
.if n \{\
.RE
.\}
.PP
开启网络时间同步服务
.sp
.if n \{\
.RS 4
.\}
.nf
$ timedatectl set\-ntp true
==== AUTHENTICATING FOR org\&.freedesktop\&.timedate1\&.set\-ntp ===
Authentication is required to control whether network time synchronization shall be enabled\&.
Authenticating as: user
Password: ********
==== AUTHENTICATION COMPLETE ===
.fi
.if n \{\
.RE
.\}
.sp

.sp
.if n \{\
.RS 4
.\}
.nf
$ systemctl status systemd\-timesyncd\&.service
● systemd\-timesyncd\&.service \- Network Time Synchronization
   Loaded: loaded (/usr/lib/systemd/system/systemd\-timesyncd\&.service; enabled)
   Active: active (running) since Mo 2015\-03\-30 14:20:38 CEST; 5s ago
     Docs: man:systemd\-timesyncd\&.service(8)
 Main PID: 595 (systemd\-timesyn)
   Status: "Using Time Server 216\&.239\&.38\&.15:123 (time4\&.google\&.com)\&."
   CGroup: /system\&.slice/systemd\-timesyncd\&.service
           └─595 /usr/lib/systemd/systemd\-timesyncd
\&.\&.\&.
.fi
.if n \{\
.RE
.\}
.sp
.SH "参见"
.PP
\fBsystemd\fR(1),
\fBhwclock\fR(8),
\fBdate\fR(1),
\fBlocaltime\fR(5),
\fBsystemctl\fR(1),
\fBsystemd-timedated.service\fR(8),
\fBsystemd-timesyncd.service\fR(8),
\fBsystemd-firstboot\fR(1)
.\" manpages-zh translator: 金步国
.\" manpages-zh comment: 金步国作品集：http://www.jinbuguo.com
